##############################################################################
###+--------+#################################################################
#+-| CDOW() |---------------------------------------------+###################
#| +--------+ Returns day of the week in character format |###################
#+--------------------------------------------------------+###################
##############################################################################
##############################################################################
#+--| Summary |--------------+################################################
#|     #INCLUDE date.hdr     |################################################
#+---------------------------+################################################
##############################################################################
##############################################################################
#+--| Syntax |-------------------------------+################################
#|     FUNCTION CHAR cdow PROTOTYPE          |################################
#|      PARAMETERS VALUE DATE date_value     |################################
#+-------------------------------------------+################################
##############################################################################
##############################################################################
##############+---| Description |--------------------------------+############
##############| The cdow() function returns the day of the week  |############
##############| represented by date_value as a character string. |############
##############+--------------------------------------------------+############
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Show the day of the week for a birthday.            |#########
#########|                                                          |#########
#########| INPUT "Enter your birthday 'dd/mm/yy' : " TO date_var    |#########
#########| ? "YOU WERE BORN ON :", cdow( date_var )                 |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    How many toys are sold on Monday?                   |#########
#########|                                                          |#########
#########| COUNT ALL FOR cdow( r->date ) = "Monday" ;               |#########
#########|  .AND. r->order = "Toys"                                 |#########
#########+----------------------------------------------------------+#########
##############################################################################